home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 1 / QRZ Ham Radio Callsign Database - December 1993.iso / ucsd / packet / tcpip / k5jb / k5jb_k31.txt < prev    next >
Encoding:
Text File  |  1993-10-12  |  6.0 KB  |  124 lines
  1. This note explains what all the k5jb* stuff is about.  KA9Q NET is the
  2. TCP/IP suite that preceeded NOS.  I use it because it is smaller, runs
  3. on both my MS-DOS and Unix machines, and does what I want to do.  Also,
  4. it is mature and meets the standards you would expect from profession-
  5. ally prepared software.  In other words, it doesn't crash.
  6.  
  7. The k31 release of the KA9Q NET doesn't have any major changes that
  8. would affect Unix or Coherent users, but has been worked over by N0QBJ
  9. and me to make it compile and operate correctly under OS9/OSK.  BM was
  10. likewise worked over.
  11.  
  12. All the source files are new with this release, except for the sample
  13. startup files that were thrown together at the request of one user.  You
  14. should download all the files to have a complete kit.
  15.  
  16.                    k5jb.k31.txt (and preface in unix.note)
  17.  
  18. Version k31 of the K5JB NET kit is a complete set of Unix and Coherent source 
  19. code files for the KA9Q NET (pre NOS TCP/IP).  It is NOT necessary to get 
  20. earlier source files to have a complete kit, but it IS necessary to get
  21. k5jb.bm.tar.Z to have a coordinated version of the mailer, BM.  Thus, a
  22. complete k31 kit consists of:
  23.  
  24. k5jb.k31.txt   -- This file
  25. k5jb.k31.tar.Z -- Source code for Unix KA9Q NET
  26. k5jb.dock31.tar.Z -- Complete user documentation for same.
  27. k5jb.bmk31.tar.Z  -- Source code for BM, the mailer.
  28. k5jb.samp.tar.Z -- Optional, Sample startup files for beginners.
  29.  
  30. (These files on ucsd.edu are either in /hamradio/packet/tcpip/incoming, or in 
  31. /hamradio/packet/tcpip/k5jb.)
  32.  
  33. These files were compressed with plain vanilla compress, and tarred with
  34. plain, old tar.  Hint:  Use tar xvfo <tarfile> to extract files with
  35. their original timestamps entact.
  36.  
  37.                         Brief description of Unix NET
  38.  
  39. NET is designed as an MS-DOS application, so does not make full use of Unix's 
  40. multi-tasking ability but runs quite well in Unix.  You can use it in a Unix 
  41. windowing environment (or in shell layers) but you must prevent blocking on 
  42. input if you make the window session inactive.  See the doc on how to do 
  43. this.  Also, a casual user shouldn't shell out of NET for an extended period 
  44. of time, as NET suspends operation during shell escapes.  If you operate a 
  45. heavily used machine, use your system's background methods and switch to 
  46. another terminal session to do other things.
  47.  
  48. If you are unfamiliar with NET (the TCP/IP suite, written by Phil Karn, KA9Q, 
  49. and preceding his current project, NOS), you need to break out the files in 
  50. k5jb.dock31.tar.Z and browse them.  k5jb.k31.tar.Z contains a file,
  51. srcnote.unix, which has modification information, and note.unix that is
  52. specific to Unix setup.
  53.  
  54.                           Brief description of kit
  55.  
  56. More detail on files contained in this set:
  57.  
  58. k5jb.k31.tar.Z
  59. Contains files needed to compile NET under various System V, Release 3 
  60. versions of Unix (I use AT&T), under Coherent, version 4.0.1 and under
  61. OS9/OSK.  This file also contains srcnote.unix, a collection of revision
  62. notes, and note.unix for information specific to Unix and Coherent that
  63. I not yet included in the main documentation.  (This .txt file is also
  64. the preface to note.unix.) W5GFE compiled NET and BM under SCO Unix (80386)
  65. Sys V, release 3, both with the native compiler and with GNU.  Others
  66. report compiling it under various versions of Unix, but were not specific
  67. on versions used.  See note.os9 for information on how to compile under
  68. OS9/OSK.
  69.  
  70. k5jb.bmk31.tar.Z
  71. Contains source for Bdale's Mailer (BM).  Works with same environmental 
  72. variables as K5JB version of NET.  Has been sanitized to prevent memory 
  73. violations.  This is not really version k31, but was updated at the same
  74. time as NET version k31 to compile and run correctly under OS9/OSK.
  75.  
  76. k5jb.dock31.tar.Z
  77. Contains NET and BM user's documentation.  Targeted for MS-DOS users, but 
  78. contains essential Unix information.
  79.  
  80. k5jb.samp.tar.Z
  81. Contains a rough set of sample configuration files for setup.  I didn't
  82. make any particular effort to cover all instances so you must look at
  83. chapter0 and decide if you want to go on from there.  This file was
  84. unchanged with the k31 release.
  85.  
  86. (The following footnote was added to the k5jb.k28.txt and that file was
  87. sent to ucsd.edu after the tar was uploaded.  I made the change and made
  88. a new tar but did not reload it to ucsd.edu.  sys/fcntl.h is missing in
  89. only the latest versions of Coherent.  As a policy, I will not be making
  90. changes to my files that would cause them to no longer work with the
  91. first version of Coherent 4 that I received, thus preventing portability
  92. problems.  You can do anything you want with your copy.)
  93.  
  94. (Footnote)  Since I uploaded k5jb.k28.tar.Z, two possible problems for
  95. Coherent users were reported to me.  In the file, telunix.c, the line,
  96. #include <sys/fcntl.h> may need to be changed to #include <fcntl.h>.
  97. The other possible problem is related to the use of the quit signal to
  98. prepare NET for background operation under shl, the shell layer manager.
  99. If you see a message to the effect that keyboard input is ignored...
  100. use a Ctrl-\ to toggle the condition.  A quit signal sent to a process
  101. from another active window may have been also received by NET.  (I
  102. couldn't easily duplicate this.)
  103.  
  104. While we are adding afterthoughts, I want to remind you that files from
  105. this suite are used to make executables for MS-DOS computers which use
  106. the IBM PC bus so some modules relate to accessory cards for that machine.
  107. Defining compiler directives like DRSI, or PC_EC, will cause your compile
  108. to fail.
  109.  
  110. Also, globally defining things like "NOTUSED" or "LATER" will have unpre-
  111. dictible consequences.
  112.  
  113. Coherent users have no need to use the Ctrl-\ (quit) switch on NET if
  114. they are using virtual terminals.  NET runs fine when its window is not
  115. active.  In fact, using the quit signal removes one of the two places
  116. where the CPU is released to do other tasks.  If you start NET with no
  117. serial ports attached (like if you have no startup.net file), and issue
  118. a quit signal to ignore keyboard input, NET will become a CPU hog,
  119. consuming an enormous amount of the machine's resources.
  120.  
  121. (End of k5jb.k31.txt)
  122.  
  123.  
  124.